OSStatus HRGoToURL( HRReference hrRef, const char * url, Boolean addToHistory, Boolean forceRefresh);hrRef - a reference to a HTML rendering object previously obtained by calling HRNewReference.
url - a pointer to a C - style string containing the url to display. This URL should begin with the resource type specifier "file:".
addToHistory - a boolean value.
forceRefresh - a boolean value.
function result - an error code or noErr if successful.
HRGoToURL can be used to ask the HTML object to display the file specified by the URL. addToHistory will be passed through to your MyHRNewURLProc if you have defined one. If forceRefresh is true, then the view rectangle will be redrawn.
OSStatus HRGoToAnchor( HRReference hrRef, const char * anchorName);hrRef - a reference to a HTML rendering object previously obtained by calling HRNewReference.
anchorName - A pointer to a C - style string containing the name of the anchor to scroll into the display.
function result - an error code or noErr if successful.
Call HRGoToAnchor to scroll display so that a particular anchor inside of the HTML image is visible.
OSStatus HRGoToPtr( HRReference hrRef, char * buffer, UInt32 bufferSize, Boolean addToHistory, Boolean forceRefresh);hrRef - a reference to a HTML rendering object previously obtained by calling HRNewReference.
buffer - a pointer to a block of memory containing the HTML to display.
bufferSize - the number of bytes in the block pointed to by buffer.
addToHistory - a boolean value.
forceRefresh - a boolean value.
function result - an error code or noErr if successful.
HRGoToPtr allows you render HTML from memory. addToHistory will be passed through to your MyHRNewURLProc if you have defined one. If forceRefresh is true, then the view rectangle will be redrawn.
OSStatus HRGetRootURL( HRReference hrRef, Handle rootURLH);hrRef - a reference to a HTML rendering object previously obtained by calling HRNewReference.
rootURLH - a handle. This handle must be allocated by the caller before this routine is called.
function result - an error code or noErr if successful.
HRGetRootURL returns a C - style string inside of a memory block refered to by a Handle that contains the root URL used for all relative links given image is currently in the display.
OSStatus HRGetBaseURL( HRReference hrRef, Handle baseURLH);hrRef - a reference to a HTML rendering object previously obtained by calling HRNewReference.
baseURLH - a handle. This handle must be allocated by the caller before this routine is called.
function result - an error code or noErr if successful.
If the HTML file showing in the display contains a <BASE>tag, then HRGetBaseURL will return a C - style string inside of a memory block refered to by a Handle containing it's value. If the file does not contain a <BASE> tag, then the Handle is set to an empty string.
OSStatus HRGetHTMLURL( HRReference hrRef, Handle HTMLURLH);hrRef - a reference to a HTML rendering object previously obtained by calling HRNewReference.
HTMLURLH - a handle. This handle must be allocated by the caller before this routine is called.
function result - an error code or noErr if successful.
HRGetHTMLURL returns the URL for the page currently visible in the display. The URL will be returned in a C - style string inside of the memory block refered to by Handle provided in the HTMLURLH parameter.
OSStatus HRGetTitle( HRReference hrRef, StringPtr title);hrRef - a reference to a HTML rendering object previously obtained by calling HRNewReference.
title - a pointer to a variable of type Str255.
function result - an error code or noErr if successful.
HRGetTitle returns the title of the HTML file visible in the display. This title is appropriate for setting a window's title.